home *** CD-ROM | disk | FTP | other *** search
/ Totally for Newton 10 / PDA10.toast / mac / Packages / Programming / 1.x / Multipickproto 1.0 / MultiPick Readme < prev    next >
Encoding:
Text File  |  1994-08-03  |  1.8 KB  |  49 lines  |  [TEXT/R*ch]
  1. MultiPick Proto Readme
  2.  
  3. This is a proto I put together to deal with the problem of picklists that are
  4. longer than 25 items. It's all fully documented within the proto, but in case
  5. you're interested, here's how to use it:
  6.  
  7.     Add it to the project file, and, where you want the list to appear, select user
  8.     proto from the palette and drag it out (normal like.)
  9.     
  10.     Set it's listItems slot to what ever you want popped up (this can be done at run
  11.     time...if there's no listItems slot, than nothing will happen.)
  12.     
  13.     Set it's text. It will automatically place a pick diamond in front of whatever
  14.     you set (unless you override it's viewSetupFormScript)
  15.     
  16.     set it's pickScript (**NOTE: DO NOT USE A pickActionScript. This is used
  17.     internally by the proto. It process the pick and passes the index of the
  18.     listItems array to what ever pickScript you have. It should take one argument,
  19.     the index of the chosen item. 
  20.     
  21.     If you want something other then "--Prev--" and "--Next--" shown at the top and
  22.     bottom of long lists, set the PrevText and NextText slots (respectively) to what
  23.     ever text you want displayed.
  24.     
  25.     If you change the listItems after setting up and opening the view, send it the
  26.     :SetUpList() message to reset it's pick lists.
  27.     
  28.     If you want a shorter than screenlength picker, change the numLines slot to the
  29.     number or lines per list _after_ the view has been set up (it will adjust to the
  30.     height of the current newton's screen, otherwise.)
  31.     
  32.     
  33.     Thats about it. This proto is freeware for free- and shareware apps, with one
  34.     caveat:     
  35.         If you use it in a piece of software, send me a copy :-)
  36.         
  37.     
  38.     If you wish to use it in a piece of commercial software, contact me for
  39.     licensing info.
  40.     
  41.         Thanks, 
  42.                 Ben
  43.                 
  44.     Ben Gottlieb                            gottlb@rpi.edu
  45.     708 Forest Ave.                        gottlb@eWorld.com
  46.     Evanston, IL                            -----------------
  47.     60202                                        (708) 864-9463 
  48.     
  49.